Отмена заказа промокодов

Запрос позволяет отменить заявку на создание серии промокодов.

Синтаксис запроса

POST https://b2b-api.go.yandex.ru/integration/2.0/promocodes/orders/cancel?order_id={идентификатор заказа}

Заголовок запроса

• Authorization: Bearer <OAuth-токен>
  Процесс получения токена описан в разделе Начало работы.

• X-YaTaxi-Selected-Corp-Client-Id — ID клиента из Личного кабинета. Обязателен, если по токену доступно несколько клиентов.

Параметры запроса

Запрос содержит обязательный параметр:

• order_id — идентификатор отменяемого заказа.

Описание полей ответа

В ответе содержится поле:

Пример запроса

POST https://b2b-api.go.yandex.ru/promocodes/orders/cancel?order_id=099...4e48
...
Authorization: Bearer <OAuth-token>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>

Пример ответа

{
    "status": "cancelled"
}

Возможные коды ответа

Ответ на данный запрос может содержать следующие стандартные HTTP-коды:

• 200 — запрос выполнен успешно.
• 400 — в запросе был передан неизвестный параметр или параметр с недопустимым значением.
• 403:
  • SELECT_CLIENT_HEADER_REQUIRED — в запросе не передан заголовок X-YaTaxi-Selected-Corp-Client-Id (возвращается в случае, если для токена доступно более одного клиента).
  • SELECTED_CLIENT_ACCESS_DENIED — в заголовке X-YaTaxi-Selected-Corp-Client-Id передан ID клиента, к которому нет доступа у этого логина.
• 404 — заказ не найден.
• 409 — произошел конфликт.